MACD 5

home *** CD-ROM | disk | FTP | other *** search

/ MACD 5 / MACD 5.bin / workbench / time / artm / english.doc / artm.doc < prev next >

Wrap

Text File | 1994-07-11 | 18.9 KB | 426 lines

ARTM Amiga Real Time Monitor V2.04 ------------------------------------- Copyright © 1990-94 by Dietmar Jansen & F.J. Mertens ARTM displays and controls activities in your Amiga. It is fully supported by Intuition and it is very easy to use. It works under WB1.3 and WB2.x properly. ARTM needs Arp.library 39.+ ARTM is a shareware program. Permission is granted freely to distrib- ute this program without profit. Copying is allowed but only if the ARTM package is complete and unchanged . If you use ARTM often, please pay us a donation of US$15. In exchange you will receive an update without the irritating requester. Please send cash, not cheques. My bank is a shark. When you send a US$15 cheque: exchange at the moment US$1 = DM1.70 US$15 = 25.00 DM - 11.00 DM charge to change a US$ check to German DM ---------- 14.00 DM Installation: ------------- Automatic Installation You can install ARTM automatically with the Commodore Installer. There is an installation script in the archive. Manual Installation Installation is very easy. ARTM is a self-contained program so you can copy ARTM with the copy command: copy ARTM <path>/ARTM into the directory of your choice. Copy the .doc files with the copy command in the same way. The ARTM.guide file should be copied to LOCALE:HELP/. copy ARTM.guide SYS:LOCALE/HELP/ARTM.guide assign HELP: SYS:LOCAL/HELP The ARTM archive contains the following files: ---------------------------------------------- ARTM ARTM.info Install_ARTM Install_ARTM.info german.doc/artm.guide german.doc/artm.guide.info german.doc/artm.dok german.doc/artm.dok.info german.doc/artm.history german.doc/artm.history.info english.doc/artm.guide english.doc/artm.guide.info english.doc/artm.doc english.doc/artm.doc.info english.doc/artm.history english.doc/artm.history.info Starting the program: --------------------- ARTM V2.00 requires Amiga Workbench 2.x and above. From Shell ~~~~~~~~~~ Type ARTM [opt] and ARTM will open on the WB Screen there are many options available: -q Will bring up ARTM in its iconified form in the upper right hand corner. -poutputpath tells ARTM where it should store its output. Any device can be specified, e.g. prt:, ram:file, etc. -ix/y Will bring up the ARTM window in its full size, but when iconified the icon will be located at x and y position. -wx/y Start ARTM as Workbench window, x/y is the upper left corner of the ARTM-Window. If the difference from x/y to the right screenside is lower than 640 pixels then ARTM will start at the upper left corner. -hx Start ARTM as Wb window, x=window.height. If the screen is shorter than x then ARTM-Window.Height = 168. From Workbench ~~~~~~~~~~~~~~ Simply double click the ARTM icon and the ARTM window will open on the Workbench screen. The options mentioned above can be used as Tooltypes. START=WINDOW|ICON ICON_POS=x/y OUTPUT_PATH=RAM:ARTM.output WINDOWHEIGHT=280 WINDOW_POS=70/16 Using the keyboard: ------------------- Keyboard codes are supported in ARTM. this version of ARTM only supports 3 keycodes. In future versions all functions should be accessible via the keyboard. The following keyboard codes are supported: ESC quit ARTM HELP the ARTM.GUIDE will pop up and show you the actual function help (see The Help function) The ARTM requester knows the following keyboard codes: ESC cancel function just like the CANCEL button. RETURN execute function just like the OK button The ARTM Help function: extensive help is available in ARTM. After hitting the help key, ARTM.guide pops up and help for the last selected function will be displayed. You must have the amigaguide.library in your Libs: directory for this function to work. Also, ARTM.guide must be correctly installed (see Installation) ----------------------------------------------------------------------- The following functions are available from ARTM: Task (default setting) lists all tasks in your Amiga. You select a task with a mouse click on the requested entry. Now you can remove it with REMOVE or change the priority with PRIORITY. The MORE function brings up further information (see MORE). This information is displayed: Address, Priority, Signals, State, Code; Type, Name. Windows lists all open screens and windows. Screens are in colour 3, windows are white. Close a window/screen by selecting its item and click on CLOSE. The MORE function brings up more information about the selected screen or window (see more). WARNING: The GURU is waiting for you if you kill a window before its task is finished. This information is displayed: Address, Position, Size, Flags, IDCMP (only by windows), Title. Libraries lists all Libraries. By clicking on any item, you can close the library with CLOSE (OpenCount must be NULL); REMOVE removes the library. PRIORITY changes the priority. This information is displayed: Address, Type, Priority, OpenCount, Version (consists of version & revision), Negsize, Possize, Name. Devices lists all devices. By clicking on REMOVE you can remove a selected device, provided it has been closed. The PRIORITY function changes the priority. This information is displayed: Address, Type, Priority, OpenCount, Version (consist of version & revision), Negsize, Possize, Name. Resources lists all resources. The PRIORITY function changes the priority and REMOVE removes a selected resource. This information is displayed: Address, Type, Priority, OpenCount, Version (consists of version & revision), Negsize, Possize, Name. Ports shows all ports and the name of their tasks. IDCMP_Ports are owned by a window. Ports are removable with REMOVE. This information is displayed: Address, PortName, Type, SigBit, Flags, TaskName. Residents lists all residents in your Amiga. Residents that were added by the KickTagPtr (e.g. a virus or RAD:) will be displayed in colour 3 and if the residents are in the Res-Modules-table too, they will be displayed in black. This information is displayed: Address, Type, Priority, Version, Flags, Name. Interrupts shows all interrupts in your Amiga. You can only remove an interrupt controlled by a server with REMOVE. This information is displayed: Address, Data, Code, Priority, Type, Nr., InterruptName, Name. Vectors show vectors, e.g. Cool-, Cold,- WarmCapture and Kickpointers. This is helpful when searching for viruses, but remember that the RAD: device in Kick 1.3 uses the KickTagPtr. Use the CLEAR function to set any Vector to NULL. If you close KickMemPtr, KickTagPtr or KickCheckSum, all of these three would be set to NULL. This information is displayed: Address, Vector and Content. Should the KickTagPtr point to a resident table, you get the Address & Name of this table, but note that only the first item of the table would be displayed. If you want to see the others, select function Residents. The residents of the KickTagPtr-table would be displayed coloured (see above). Memory show the memory in chip, fast and expansion ram (like the AmigaDOS avail command). The PRIORITY function changes the priority. If you select the memory (chip or fast) and click MORE then ARTM will show you the memory fragmentation. This information is displayed: Address, Priority, Attribute, Lower, Upper, Maximum, in Use, Free, Largest, Name and in the next column the totals. Mount lists all mounted Devices in your Amiga. This information is displayed: Address, Device, Heads, Sectors, Buffer, Cylinder, Interleave factor, Handler name. With storage units ARTM will also display Size, Full, rw (read/write status), Volume (name). Assign shows all assigned paths and programs. This information is displayed: Address, Directory, Path. Locks shows all Locks (read and write). If you have more than 200 Locks (ARTM has 100 Arrays) you can see the next or previous 100 Locks with the Forward or Backward function. Select a Lock and choose Unlock to remove the selected item. This information is displayed: Address, Access, Path. Fonts lists all loaded fonts, in KickRom too. With REMOVE you can remove the selected Font. If you quit the program that used the font (Count = NULL), the system should release the requested memory. This information is displayed: Address, Count, YSize, XSize, Style, Flgs, LoChar, HiChar and Name. Hardware lists all installed autoconfig-boards (ExpansionBase). ARTM will show you which processor and maths coprocessor are in your Amiga. In addition ARTM indicates the new ECS-Chips Fat Agnus or Fat Denise (PAL or NTSC) or normal Agnus and Denise. This information is displayed: Address, Boardadr, Boardsize, Slotadr, Slotsize, Driver, Product, Type and Manufacturer. Res Cmds lists all commands made residents with both AmigaDos and the ARP1.3 ARES command. The AmigaDos residents will show all datasegments with Lower Adr, Upper Adr and Size. This information is displayed: Sys (AmigaDos or ARP), Name, Usage (only with ARP), Access. Semaphores show all Semaphores from AmigaDos. With REMOVE you can remove the selected Semaphore but the Semaphore will automatically be released first. With RELEASE you can release any Semaphores. This information is displayed: Address, Priority, NestCount, WaitQueue, Name, OwnerTask. Monitor is a little memory monitor and shows the whole memory. The memory will be loaded into the 100 ARTM stringgadg- ets. You can view the next or previous 100 records with Forward and Backward. A click on Address will bring up a requester, type an address in it and the Monitor lists the next 100 records from that address. This information is displayed: Address, Bytes(Hex), Bytes(ASCII) Last Alert shows the last Alertnumber and address. ----------------------------------------------------------------------- Remove removes selected tasks, libs, devices, ports, interrupts, semaphores, and Fonts. Select the entry to be removed with a mouseclick. But remember libs and devices must be closed. Close closes screens/windows and libraries. Use it as remove. Releases release Semaphores from SignalSemaphore. Clear sets the SystemVectors to NULL. Use it as remove or close. Freeze freezes a running Task and removes it form the node structure. The frozen task structure is stored. It will be labelled as "Frozen" under the SATE column on the Task display. If you select a frozen task and click on Activate then the task will start running again. Activate is the opposite of Freeze (see above). Priority changes the priority of a selected task, library, device interrupts, memory or resource. Values may range from -128 to 127, though it's better to use values between -10 and 10. Unlock removes a Lock (read or write) from the list. ATTENTION: if the system is using the Lock then your Amiga will get a visit from the Indian. More shows detailed information. In ARTM version 1.0 this was implemented for the Task, Windows, Screens, and Memory functions. Example: Click on the required task and then on MORE. This is the result for any task. Task Structure: IDNestCnt: 0 TDNestCnt: -1 SigAlloc: c000ffff SigWait: c0000000 SigRecvd: 00000000 SigExcept: 00000000 TrapAlloc: 8000 TrapAble: 0000 ExceptData: 00000000 ExceptCode: 00fc2ff0 TrapData: 00000000 TrapCode: 00ff47ea SPLower: 00266834 SPUpper: 00267034 SPReg: 00266f96 Switch(): 00000000 Launch(): 00000000 UserData: 00000000 Process Structure: WindowPtr: 00000000 Title: MsgPort: 00000000 StackBase: 00266834 StackSize: 2048 CurrentDir: 00000000 Path: CIS: 00000000 COS: 00000000 ConsoleTask: 00000000 FileSystemTask: 0020709c SegList: 002365e4 SegPointer: 0024940c PktWait: 00000000 CLI: 00091bc3 CommandLineInterface Structure: CommandDir: 00246874 StandardInput: 00000000 StandardOutput: 00000000 CurrentInput: 00000000 CurrentOutput: 00000000 Module: 00000000 Hunks: Lower Upper Size ----------------------------------- 00249410 00249a6c 1636 0022ee80 0022ee80 8 total: 1644 For Windows, and Screens the result is similar. Memory will show the memory fragmentation in address and size. Break cancels a running Task. The selected task will be sent Ctrl-D/E/F/C Signal A requester pops up where you can change the SigAlloc (see Break) Cancel switches the gadgetrow from action (colour 4) back to function (colour 2). Monitor Functions ----------------- Address Pops up a little Requester. Enter an address and it and the next 99 addresses will be displayed. Forward lists the next 100 rows. Backward lists the previous 100 rows. Search Pops up a little Requester. Enter an ASCII string and ARTM will search memory for it. Title Bar Gadgets ----------------- zz Iconify function. If you chose the zz gadget ARTM disappears and puts an icon on the Workbench. A double click on this icon will bring ARTM's main window back. i i is like ABOUT Disk symbol stores all items from the currently displayed function to a file or prints it out to PRT: (see -p option above) ----------------------------------------------------------------------- Note : If you use the hardware function and have autoconfig boards (ExpansionBase) installed that aren't properly recognised by ARTM then please write to us and tell us the output from ARTM (PROD, TYPE and MANUFACTURER) and also the name and Type of your expansion boards. You should always be careful of what you're doing! Please send bug reports and a list of features you would like to have in the next version to the Authors: Franz Josef Mertens Sonnenrain 17 72218 Wildberg 1 Germany Fido (2:246/2013.9) Mentopolis Wildberg UUCP fjm@merlin.tynet.sub.org Special thanks to everyone who helped us with little routines, tips and error tracking and all Beta testers. Special thanks to: Matthias Zepf, Markus Stoll, Matthias Scheler, Kai Bolay, Marc Heuler, Gregor Hutla and Paul Browne.